home *** CD-ROM | disk | FTP | other *** search
- _____________________________________________________________________
- \
- HamEdit10 |
- Written by James Carpino of Resolution Computer Research (RCR). |
- I am placing this program in the public domain. |
- This program may be copied in its |
- entirety and distributed, and may not |
- be used or sold for commercial use. |
- Resolution Computer Research is currently a small non-profit |
- software development company devoted to the development of |
- software and hardware for the Commodore 64/128 and Amiga PCs. |
- WE ARE NOT RICH so if you find any RCR programs useful |
- please feel free to send a donation of $2 or more to: |
- ---------------------------------\ |
- James Carpino | |
- Resolution Computer Research | |
- 86-08 106th street Richmond Hill | |
- New York, NY 11418 | |
- ---------------------------------/ |
- We are also currently working on: |
- HAM (Hold-And-Modify) Image Editor: This is this program. Enjoy it. |
- We're always improving it and updating it. |
- HAM library for C language, to use HAM in your own software. |
- Theese routines are used in HAM Image Editor. |
- Emily-64: a 6502 microprocessor emulator to enable the Amiga |
- to eventually run Apple II, Commodore 64, and Atari 800XE |
- software. This will hopefully run at full speed, but we NEED |
- a developer's kit or Manx C compiler/assembler donation TO |
- accomplish this. |
- Dimension-Three: AmigaBasic program to plot three-dimensional |
- formulas on any resolution screen (including interlaced). |
- EditWave: AmigaBasic program to edit 256-byte waveforms with |
- sine, square, triangle, etc. waveforms and mixing. |
- _____________________________________________________________________/
- \
- Any donations will be recorded with the donor's name |
- and put towards our development needs. If, at any point, |
- we succeed in developing products worthy of sale for a profit, |
- any donations will be returned at the rate of twice the donated |
- value. Until we are on our feet (business-wise) we can make |
- no promises as to the return of donated funds, equipment, etc. |
- _____________________________________________________________________/
- \
- The Instructions: *
-
- How to use HamEdit10:
- Call the program from AmigaDos, using the following paramaters:
- HamEdit10 -h[height] -w[width] -i
- Leaving out the -h and -w paramaters will cause HamEdit10 to default to
- the 320*200 screen format. Any height over 232 will be made interlaced.
- Using the -h option with no parameter will cause height to default to 400.
- Some examples:
- HamEdit10 -h233 ;Creates a HAM screen 320 by 233 interlaced.
- HamEdit10 -w352 -h ;Creates a HAM screen 352 by 400 interlaced.
- HamEdit10 -h100 -w100 -i ;Creates a HAM screen 100 by 100 interlaced.
- HamEdit10 -h230 ;Creates a HAM screen 320 by 230 non-interlaced.
- HamEdit10 -w336 -h156 -i ;Creates a HAM screen 336 by 156 interlaced.
- HamEdit10 -i ;Creates a HAM screen 320 by 200 interlaced.
- It is important to remember that the Amiga hardware can do low-resolution
- screens up to 368 dots in width, and high-resolution screens up to 736 in
- width. Under Kickstart 1.1, though, these screens will not work properly
- unless perfectly centered by Preferences (the screen position slider), and
- screens over 352 (704 hires) will not work at all, regardless of the slider.
- Under Kickstart 1.2, the screen will work properly regardless of the
- position of the Preferences screen slider, though you may not see all of
- it. As for height, non-interlaced screens may go up to 236 in height and
- interlaced screens may go up to 472 in height. Again, if the screen is not
- positioned correctly, it may not work properly under Kickstart 1.1. If the
- screen is above 200 or 400 interlaced, 1.1 will not show that part which
- streches over the limit. The only way to remedy this in 1.1 is to go to the
- top of the screen, and drag the screen drag bar upwards until all the screen
- is visible. The screen will not move, but the bottom border will, and the
- mouse pointer will point to a position several dots lower. In Kickstart
- 1.2, the entire screen will automatically be visible (provided the
- Preferences screen position gadget is in the upper left corner), but the
- pointer will not reach below the 200 (or 400 interlaced) limit.
- "Wait a minute- did he say ALL? Uh- I can't see all of it, my 368 by
- 472 screen goes off the screen no matter what I do!" says a fairly well-
- educated experimenter, who is sure he has the preferences slider all the
- way to the upper left. He has a problem: His monitor will not physically
- display a screen much larger than 320 (or 640 hi-res) by 200 (or 400
- interlaced). This is true of all the current Commodore monitors and most
- color monitors. They do something called overscanning. This is so the
- scanning gun in the CRT (Cathode Ray Tube) has time to get from the right of
- the screen to the left of the screen, and from the top to the bottom. It is
- different on most monitors (TV's, composite, RGB, etc.) so the Amiga uses
- the position gadget in Preferences to make sure most of the screen is
- visible. If you have a monochrome monitor, or an old-fashioned color TV
- with all the controls, you can change the Horizontal and Vertical size;
- usually the smallest settings will allow for most of a 368 by 472 screen to
- be displayed. Some expensive RGB monitors will display the larger screens,
- too; and if you have an expensive high-persistence phosphor monitor which
- displays the full 368 by 472 screen, you're rich and you should have bought
- a XEROX mainframe with a few graphics terminals.
- Now, back to our little graphics editor. The commands are summarized as
- follows:
- d --Goes to draw mode (full lines), just like in DeluxePaint.
- s --Goes into spots mode (dotted lines), just like DeluxePaint.
- , (comma key) --Picks a color from anywhere on the screen, not including
- the palette; this is similar to DeluxePaint, but the color is chosen
- immediately. This can be held down to roll through colors on screen.
- . (period key) --Changes the brush size to 3*3, similar to DeluxePaint.
- - (minus key) Reduces the X and Y size of the brush. (DeluxePaint)
- = (Equals key, look at the plus sign) Increases the width of the brush.
- \ (Backslash key, next to the = key) Increases the height of the brush.
- HELP --Redraws all the information and fixes brush size, color, and
- drawing mode to default; also pops back menu bar and windows to
- original positions.
- F10 --Pops in and out the MENU bar, to allow for the full screen height.
- [ and ] --Change the current color to one of the 16 colors; these are
- fast and are not HAM colors. (These keys also work in DeluxePaint)
- 8-9,5-6,2-3: Up and down for HAM red, green, and blue, respectively.
- The current HAM color is also displayed as standard color #8. (These
- keys also work in DeluxePaint)
- Del --(above the BackSpace key) Clears the screen and does HELP.
- ESC --The beloved escape key- Exits the program, relieving you of the
- terrible wrath of drawdom.
-
- The Color and Info windows can be moved anywhere you like, but currently
- they cannot be popped away.
- If you click or move either of the Color or Info windows, the first click
- you make in the drawing screen will not draw; this is so you do not goof up
- a picture just for the sake of selecting the correct window. The Info&Color
- windows will tell you in the title bar when they are selected to remind you
- of this.
- The Info window has the pen position in its title bar, and within the
- window are listed the pen width and height, color, and red, green, and blue
- elements of the current pen color.
- Clicking within the color window chooses any of the colors displayed
- within the color window, including the bottom 16 colors. Color #8 will
- always turn to the current color, so there's no purpose to using #8.
- The current color number will also appear in the info window. The size of
- the color window depends on the size of the screen; when the screen size
- is shorter than 300, not all the colors will be displayed.
- Remember to fix Preferences to 80 columns, HamEdit10 currently does not
- open its own font; this saves memory and time.
- If your screen will be larger than normal, remember to move the screen
- slider in Preferences to the upper left.
- The penwidth can be no less than 3 dots wide because it takes 3 dots to
- makea HAM color: 1 for red, 1 for green, and 1 for blue. If you have to
- increase the size of the brush drastically, increase the height; height is
- drawn faster than width. You can, however, draw with a brush 1 dot wide if
- you are using one of the bottom 16 colors.
- If there is anything I've forgotten, you'll notice it before long.
- HamEdit still does not save, load, undo, and all those lovely features that
- normal painting programs have. HamEdit is still being worked on, and all
- those features will be added in the future. First priority are load/save
- and shading, before anything else; one of these two features will appear in
- HamEdit11. If you find any bugs or awkwardnesses (besides the awkward word
- awkwardnesses) please tell me about them. We sometimes forget to fix even
- the bugs we know about.
-
- Sincerely,
- James Carpino, Programmer
- Resolution Computer Research
-
-